package com.atguigu.srb.common.result;

import lombok.Data;

import java.util.HashMap;
import java.util.Map;

/**
 * 统一返回结果类
 * 用于封装后端返回给前端的通用数据结构
 * 包含状态码、消息和数据三个核心属性
 * 提供链式调用方法方便构建返回结果
 */
@Data
public class R {
    /**
     * 响应状态码
     */
    private Integer code;

    /**
     * 响应消息
     */
    private String message;

    /**
     * 响应数据，使用键值对存储
     */
    private Map<String, Object> data = new HashMap<>();

    /**
     * 构造函数私有化，防止外部直接实例化
     * 强制使用静态方法创建实例
     */
    private R() {
    }

    /**
     * 返回成功结果的静态工厂方法
     * 默认使用ResponseEnum.SUCCESS的状态码和消息
     *
     * @return R实例
     */
    public static R ok() {
        R r = new R();
        r.setCode(ResponseEnum.SUCCESS.getCode());
        r.setMessage(ResponseEnum.SUCCESS.getMessage());
        return r;
    }

    /**
     * 返回失败结果的静态工厂方法
     * 默认使用ResponseEnum.ERROR的状态码和消息
     *
     * @return R实例
     */
    public static R error() {
        R r = new R();
        r.setCode(ResponseEnum.ERROR.getCode());
        r.setMessage(ResponseEnum.ERROR.getMessage());
        return r;
    }

    /**
     * 根据自定义响应枚举设置结果的静态工厂方法
     * 可自定义状态码和消息
     *
     * @param responseEnum 自定义响应枚举
     * @return R实例
     */
    public static R setResult(ResponseEnum responseEnum) {
        R r = new R();
        r.setCode(responseEnum.getCode());
        r.setMessage(responseEnum.getMessage());
        return r;
    }

    /**
     * 链式调用：添加单个数据项
     *
     * @param key   数据键
     * @param value 数据值
     * @return 当前R实例，用于链式调用
     */
    public R data(String key, Object value) {
        this.data.put(key, value);
        return this;
    }

    /**
     * 链式调用：批量添加数据项
     *
     * @param map 包含多个数据项的Map
     * @return 当前R实例，用于链式调用
     */
    public R data(Map<String, Object> map) {
        this.setData(map);
        return this;
    }

    /**
     * 链式调用：自定义响应消息
     *
     * @param message 自定义消息内容
     * @return 当前R实例，用于链式调用
     */
    public R message(String message) {
        this.setMessage(message);
        return this;
    }

    /**
     * 链式调用：自定义响应状态码
     *
     * @param code 自定义状态码
     * @return 当前R实例，用于链式调用
     */
    public R code(Integer code) {
        this.setCode(code);
        return this;
    }
}